- Syntaxe
Pour rappel, la syntaxe est la combinaison de la grammaire et de l'orthographe du Java.
Elle comporte des règles qui sont obligatoires, et certaines qui sont des recommandations pour le développeur, qu'on appelle des conventions d'écritures.
C'est grâce à la syntaxe précise du langage que le compilateur peut comprendre notre code et le traduire en bytecode. Si la syntaxe n'est pas respectée par un développeur, le compilateur va afficher des erreurs indiquant qu'il n'arrive pas à comprendre ce qu'on a voulu écrire à cause de la mauvaise syntaxe.
Les commentaires
En Java, il est possible d'écrire du texte qui est a destination du développeur et pas de la machine. Il ne fait pas partie du programme mais est présent au milieu du code pour aider à comprendre ou expliquer ce qu'il se passe. On appelle ça un commentaire et c'est très pratique !
Il existe deux façons d'en écrire :
// commentaire sur une ligne
// un autre commentaire sur une ligne
/*
Commentaire sur
plusieurs
lignes
*/
Soit on écrit // ("slash-slash") puis on ajoute notre texte juste après sur la même ligne. Ça permet d'écrire un commentaire sur une ligne. Pratique pour une petite phrase ou une courte explication.
Sinon, si on a besoin d'un commentaire plus long, on peut opter pour le commentaire sur plusieurs lignes en commençant par /* ("slash-étoile"). Tout se qui se trouve entre le début de ce commentaire et sa fin marquée par */ ("étoile-slash") sera considéré comme un commentaire et ne sera donc pas compté comme du code à exécuter.
Le point-virgule
Oui, j'en fais une section dédiée même si ça semble ne pas être grand chose mais en java, toutes les instructions doivent se terminer par un point-virgule ;. Sans ça, le compilateur va se plaindre qu'il ne comprend pas ce que vous voulez dire.
Quoiqu'il en soit, l'IDE saura vous indiquer les erreurs de syntaxe, et vous proposera souvent des solutions pour les corriger. Au minimum il essaiera de trouver l'origine de l'erreur pour que vous la corrigiez vous même.
"Ahhh là là, je ne vois vraiment pas ce que vous voulez dire, il manque un point virgule" - Le compilateur
Les conventions d'écriture
Les conventions d'écriture du code sont des décisions généralement admises par les développeurs afin que le code de tout le monde respecte des règles communes pour pouvoir s'y retrouver plus facilement quand on partage du code avec des camarades.
L'indentation
L'indentation consiste à décaler le code vers les côtés en mettant des espaces au début de la ligne dans certaines situations :
- à l'ouverture d'un bloc de code, on décale vers la droite
- à la fermeture d'un bloc de code, on décale vers la gauche
Un bloc de code est défini par les accolades qui l'entourent. Je peux par exemple définir un bloc de code vide : {}.
La taille de l'indentation est réglable dans les paramètres de votre IDE si vous souhaitez la modifier.
Par défaut celle ci est de 4 espaces, mais j'ai tendance à préférer une indentation avec une taille de 2 espaces pour gagner de la place. C'est purement esthétique et ne changera rien au code que nous allons écrire.
Voici un exemple contenant des notions que nous verrons plus tard :
public class Example {
// contenu de la classe
void main() {
// nouveau bloc de code
} // fin du bloc de code du main, je reviens un coup à gauche
} // fin du bloc de code de la classe Example, je reviens un coup à gauche
// je suis en dehors de la classe
Retenez juste que chaque ouverture d'accolade { indique un nouveau bloc de code, donc une indentation qui se décale vers la droite.
Ne vous en faites pas trop pour la logistique des indentations, votre IDE s'en chargera pour vous à mesure que vous écrirez votre code.
La taille de l'indentation est généralement admise à une valeur de 2 ou 4, ce sont les valeurs rencontrées la plupart du temps.
camelCase
On notera aussi les conventions de nommage. Outre le fait que les noms des fichiers doivent obligatoirement commencer par une majuscule, si ceux ci contiennent plusieurs mots on adoptera la convention appelée camelCase. Elle consiste à ajouter une majuscule à chaque nouveau mot pour améliorer la lisibilité puisqu'il n'est pas possible de les séparer par des espaces.
voilaUnExempleDePhraseEnCamelCase. Cette convention s'applique à tout se qui doit avoir un nom.
Il existe d'autre conventions comme le snake_case qui consiste à écrire en minuscule et séparer les mots par des underscores _ (le tiret du bas). Celle ci n'est pas utilisée en Java mais on la retrouve dans d'autres langages comme le C par exemple.
Position des accolades
La position des accolades ouvrant un bloc de code est parfois débattue, mais la règle générale veux qu'on positionne les accolades à la fin de la ligne qui ouvre le bloc de code :
void main() {
}
Il existe une autre façon de faire moins répandue :
void main()
{
}
Techniquement ça ne change rien, mais je préfère esthétiquement la première méthode. C'est aussi celle qui est largement admise.
Il y a de nombreuses règles de syntaxe en Java mais nous les verrons au fur-et-à-mesure de notre progression. Par exemple, il y a une syntaxe pour déclarer et initialiser des variables. Si si ! Suivez moi !